MathEngine Karma 
----------------

This release is MathEngine Karma version 1.2.1, which includes:
 - Karma Dynamics 
 - Karma Collision 
 - Karma Simulation Toolkit

The Karma Viewer (MeViewer2) is included to provide basic rendering and
a user interface for the example programs. The viewer supports both the
OpenGL and DirectX (version 7.0 or better) APIs.  Demo executables and 
example source code are provided.

NOTE: Please read the license agreement in the file named License before 
using any of the software in this distribution.

The target runtime and developer platforms for Karma are PlayStation2, 
Windows 98, Windows 2000, GameCube and Xbox. (Linux available on request). 

Downloading Karma
-----------------

Platform-specific archives are available for download from the downloads
page on the MathEngine corporate website <URL:http://www.mathengine.com/>

Untar or unzip the appropriate archive file for your platform into an
empty directory.

Documentation
-------------

Documentation for Karma is accessed through the 'index.html' file in the
'metoolkit' directory.  Select 'index.html' to view the documentation. 

Note that the documentation references source code examples in its
discussions. You will find the code for these examples under
'metoolkit/src/Demos' and 'metoolkit/src/TechDemos'.

The documentation is browser based, and consists of PDF and HTML files.

You will need a Web browser and Adobe Acrobat Reader. You can download
Acrobat Reader from <URL:http://www.adobe.com/>.

Please refer to the MathEngine website <URL:http://www.mathengine.com/>
for additional or updated documentation.

Example Programs and Demos
--------------------------

The bin directory contains executables for all demos.

For the demos 'F1' displays/hides Help.

Karma Layout
------------

* The 'metookit/include' directory contains all the Karma include files.
* The 'metookit/lib.rel' directory contains all the release libraries.
* The 'metookit/lib.chk' directory' contains all the check libraries.
* The 'metookit/src/components' directory contains subdirectories for each
    module for which source code is provided.
* The 'metoolkit/src/Demos'  and 'metoolkit/src/TechDemos' directories 
    contain source for the demos.

Contacts
--------

The Corporate MathEngine website <URL:http://www.mathengine.com/>

Email:
  sales@mathengine.com    - sales information and general enquiries
  support@mathengine.com  - technical support for Karma
